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An introductory user manual is a tutorial introduction to a software 
product. In other words, use of the product is explained in a 
stepHDy-step, user-friendly format that walks you through sane 
fundamental aspects of the product. When you complete the 
introductory manual, you have the experiential basis for understanding 
the products 's user reference manual. 

User reference manuals are written for those v^o are new to the 
product (but v^o have read the introductory user manual) as well as 
for the experienced user. 

System manager reference manuals contain information for those v^o 
perform administrative tasks associated with routine syston operation. 

Programmer reference manuals are written for programmers who at least 
understand programming fundamentals. 
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TnOGRAPHICAL CONVENTIONS USED IN THIS MANUAL 



Uppercase letters within text indicate sample command line character 
strings, file designations, diagnostic messages, and reports. Such 
samples are in uppercase when run into the text so tiiat you can 
distinguish what would be typed (or what would appear) on the screen. 
Examples set off from the text are in lowercase. 

Bold facing indicates what you should type onto the screen, i.e., 
v^ereas uppercase characters indicate -«y>mpi ^ character strings, etc., 
that are part of an example, bold faced characters indicate what you 
must type as part of a procedure. 

Square brackets, [], indicate a function key, the name of which 
appears in uppercase within the brackets, e.g., [RE1RN] , [CTRL] , etc. 

Underlining is used for emphasis. 
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CHAPTER 1 
OVERVIEW 



The WICAT Multi-user Control Syston (WMCS) LINK Program is a 
programming tool used to prepare the output of a compiler or assembler 
so that that output can be executed by the computer's hardware. 
Therefore, LINK produces a file that is an executable image. 

The executable image has sharable and nonsharable segments. Sharable 
segments can be shared by more than one process. 

LINK also creates a listing of symbols and addresses useful for cross 
referencing. 

The description of the LINK Coranand, in the WICAT Multi-user Control 
Systan (WMCS) User Reference Manual/ tells you how to execute LINK. 



1.1 1HE ROLE OF THE LINKER 

The object modules created by language translators (including 
assemblers) are nonexecutable. External symbol references are 
unresolved. Unresolved symbol references include run-time 
modules required by high level languages as well as 
user-specified external declarations. The linker binds the 
symbol reference with the symbol definition and creates a memory 
image that can be read into manory and executed. Without a 
linker, modular programming is impossible, and language 
translators would be much more complex. 



1.1.1 Program Modules 

Modular programming, the process of combining separately 
compiled or assembled modules into an executable image, 
sinplifies and enhances program development in the 
following ways: 

1. Smaller modules are easier to write and maintain 
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because it is easier to find and fix errors in a 
smaller module. 

2. Many modules are applicable to more than one 
task, and modules that have been used and tested 
in other programs can be included in new 
applications. This speeds program development. 

3. Complicated programming requironents are 
siirplified by breaking the requironents into 
smaller tasks, each of which can be allocated to 
a different person for iraplonentation and 
debugging. 

4. In sane cases, the best language for one module 
may not be best for another part of the program. 
Modular programming allows modules written in 
different programming languages to be combined in 
a single application. Thus the programmer can 
use the language most suited to the application. 
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Figure 1,1 illustrates the role of the linker in modular 
programming wherein TI^E is a computer program that 
interacts with the user to set the syston clock on a WIOVT 
system. The interaction is achieved through a main 
program written in WIQ^T Pascal. The clock is actually 
set by an assembly language program written in WICAT 
Assembler . 



TIME. PAS 





LINK 



TIME. EXE 



Figure 1.1. Modular Programming 



1-3 



OVKW/IEW 



1.1.2 Compilation And Assembly 

LINK siirplif ies the work done by language translators 
because it assigns code to executable pages. 



1.2 LINK FUNCTIONS 

LINK produces two files: 

1. An executable- image file (EXE is the file extension for 
this file) . 

2. A cross reference-map file {MCR is the file extension 
for this file) . 

These files are discussed in the following sections. 



1.2.1 Executable- image File 

An executable- image file is file type number 1. The 
record size of the file is 1024 bytes and the first record 
of the image file contains bit mapsr each of which is 256 
bytes long. These maps r^resent logical address space. 
Each of the bits in a map is a semaphore for a 1-Kbyte 
segment of address space. The first map defines the 
correspondence between the records on the disk and their 
ultimate location in memory. The second map defines the 
initial memory allocation. The third map indicates v^ich 
pages can be shared. 

The fourth map is not used on a WICAT computer. 



1.2.2 Cross Reference Map File 

This file is a listing file that specifies each module 
name and starting address. 
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CHAPTER 2 
SYMBOLS AND REFERENCES 



link's primary responsibility is to resolve symbolic references 
between modules. 



2.1 DEFINITION 

A symbol is an identifying label or name associated with one or 
more program statanents or data area. A reference is the use of 
a symbol in a program statanent of data definition. 

Figure 2.1 illustrates a sample program called TEST. The program 
is written in Pascal and consists of one main routine and one 
subroutine. 
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I PRCXS^AM TEST; 
2 

3 VAR I : INTEGER; 
4 

5 PROCEDURE INCREMENT; 

6 BEGIN 

7 I := I + 1; 

8 END; 
9 

10 BEGIN 

II I := 0; 

12 INCREMENT; 

13 END. 

Fig 2.1 Sample Program 
These are the symbols used in TEST: 

TEST The name of the main routine 

INCREMENT The name of the subroutine 

I The name of a data area or variable 

These are the references used in TEST: 

line 7 I is referenced twice 

line 11 I is referenced once 

line 12 The subroutine INCRET'ENT is called 

2.2 TYPES 

Symbols are one of two types: local or global. LINK treats each 
type differently. 



2.2.1 Local Symbols 

Local symbols can be referenced only in the routine in 
which the local symbols are defined. 

Note that for a program such as that in figure 2.1 (where 
there are no local symbols) the compiler or assembler 
resolves all references to local symbols. 
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2.2.2 Global Symbols 

Global symbols can be referenced by routines other than 
the routine that defines them. For example, in figure 2.1 
all symbols are global because they are defined by TEST 
(the nain routine) and are therefore global to all 
subroutines. LINK resolves global symbol references (see 
chapter 4) . 

Global symbols are of two types: 

1. Internally defined symbols, defined in the main 
program. 

2. Externally defined symbols, defined in a routine 
that is external to the main program, and 
independently compiled (e.g., runtime routines 
used by Pascal) . 
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CHAPTER 3 
OBJECT MODULES 



3 .1 DEFINITION 

The output (or object) file for the compiler or assembler is the 
input file for LINK. An object file consists of modules. In the 
case of the Pascal compiler, a discrete module is created for 
each procedure in the program along with one for the main program 
itself. An additional module is created for global variables. 
In chapter 2, figure 2.1, we examined a siirple Pascal program. 
Figure 3.1 illustrates the modules created by the compiler. 



Increment 




Global s 



Fig. 3.1 Modules Created By PASCAL Compiler For TEST Program 

A module can contain several records. An object record has the 
following hexadecimal format displayed in bytes: 



I iByte 1 I Code I Code 

I Type 1 Count I Relative Address IByte 11 Byte 2 



I Code I Check 
IByte n| Sum 



Fig, 3.2 Object Record Format 

This is an explanation of the terms appearing in figure 3.2: 
Type 



Byte Count 



Type of object record described in 3.2, 
a label. 

Number of bytes in the record following 
the record type (not including the byte 
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Relative Address 
Code Byte 



Checksum 



count itself) . 

Relative address of the code bytes in 
the module. 

In the case of a code type record, the 
code bytes contain the actual 
hexadecimal code for the module; in the 
case of a symbol, the code bytes contain 
a name. 

The checksum is the one's complement of 
the sum of the bytes. 



Diagrams showing the format of each type of record are found in 
appendix D. 

Figure 3.3 shows the hexadecimal object file created by the 
Pascal compiler for program TEST (shown in figure 2.1) . Note, 
the three modules relating to figure 3.1. 
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Relative 
Type Count Address 



Code/ASCII String/Checksum 



RP I 05 

Rl I OC 

R2 I OB 

R7 I OA 

R8 I 05 



RP 
Rl 
R2 



RP 
Rl 



R7 
R7 
R7 
R7 
R8 



Rl I 
Rl I 
R8 I 
R9 I 



05 
OF 
17 



R7 I 16 
R8 I 05 



05 
OA 



R2 I 25 

R2 I OB 

R7 I 16 

R7 I 16 



OB 
16 

OP 
OB 
05 



05 
16 
05 
05 



00000000 I EA 

00000000 I 2E53544152542E09 

00000000 I 4EF900000000AD 

00000002 I 544553543083 

00000006 I F4 



Branch to start 
of nain program 



00000000 I FA INCREMENT module 

00000000 I 494E4352454D454 E54311A 

00000000 I 4E56FFFC2D0D527 J000000'^^ 2A5E4E5E4E7503 

00000008 I 2450415343414C2D474C4F42414C242D32A8 

00000012 I E8 



00000000 
00000000 
00000000 
00000020 
00000002 
00000008 
OOOOOOOE 
00000014 
OOOOOOIC 
00000022 
00000026 



FA TEST module 

544 553543085 

2F3 dOOOOOOd6J 2F3C i00000028i 4EB dOOOOOOOOl 427 ^0O0O04A| 2A4E4ESS i00OO0O0O( 4B 
4EB93000000CGD 



2450415343414C2D474C4F42414C242D32AE 

24504153 43 41 4C2D474C4F42414C242D32A8 

52525230303060 

2450415343414C2D474C4F42414C242D329C 

494E4352454D454E5431FE 

5252523 030314B 

D4 



00000000 I FA GLOBAL nodule 

00000000 I 2450415343414C2D474C4F42414C242D32B0 

0000004C I AE 

00000000 I FA 



Fig. 3.3 Object File For TEST Program 

Each record begins with a record label r 'R' , followed by an 
integer between and 9 or one of the alphabet characters 'I' or 
'P'. References to global symbols (subroutines, variables, etc.) 
must be made using the M68000 absolute long addressing mode. In 
the object file, using figure 3.3 as an illustration, all 
references to internally and externally defined global symbols 
(refer to chapter 2) are enclosed in a box. Note, all references 
to internally defined global symbols have an offset into the 
global module while all references to externally defined global 
symbols have an address value of 0. These global references can 
be better understood by studying a listing of the assembly code 
generated by the compiler for TEST. This listing is illustrated 
in figure 3.4. 
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WICAT Pascal Version 1.3 

/•procedure: increment { 1) 
0000 4E56 link a6,#-4 





FFPC 






0004 


2D0D 


move.l 


a5,-(a6) 


0006 


5279 


addq.w 


#1,74 




0000 
004A 




global 


OOOC 


2A5E 


move.l 


(a6) +,a5 


OOOE 


4E5E 


unlk 


a6 


0010 


4E75 


rts 




; procedure: test( 0) 
0000 2F3C move.l 


#6,-(sp) 




0000 
0006 




global 


0006 


2F3C 


move.l 


#40,-(sp) 




0000 
0028 




global 


OOOC 


4EB9 


jsr 


xxxxxx 




0000 




RRROOO 




0000 






0012 


4279 


clr.w 


74 




0000 
004A 




global 


0018 


2A4E 


move.l 


a6,a5 


OOIA 


4EB9 


jsr 


xxxxxx 




0000 




INCREMENTl 




0000 






0020 


4EB9 


jsr 


xxxxxx 




0000 




RRHDOl 




0000 







Fig. 3.4 Assembly Code Generated By Compiler For TEST Program 
Note the following: 

1. Global reference for I following address 0006 in module: 
INCREMENT 

2. Global references for I in module: TEST, following 
address 0012. 

3. External reference for runtime routine RRROOO following 
address C. 

4. External reference for INCREMENT module following 
address lA. 
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5. External reference of runtime routine RRROOl following 
address 20. 



3.2 PECORD TYPES 

There are four broad categories into v^ich all object module 
records can be classified: 

1 . Delimiter . 

2. Code. 

3. Constant/label definitions. 

4. References to global symbols. 



3.2.1 Delimiter 

There are six record types in this category, as defined by 
the second character in the type field: 

RP Delimits a sharable segment; pure storage. 

RI Delimits a nonsharable segment; impure storage. 

RO Identifies the main program. The program name 

is coded in the code bytes. This record 

delimits the sequence of records pertaining to 
the main program. 

Rl Identifies a module or subroutine- The module 
name is coded in the code bytes. This record 
delimits the sequence of records pertaining to a 
module. 

R8 This record marks the end of a module. The 
address of the first free location past the end 
of the module. LINK uses this offset from the 
start of the module to determine where it can 
start loading the next module. This record 
contains the amount of space used by the module. 

R9 This record marks the end of the object file. 
An object file can contain several modules. 
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3.2.2 Code 



An R2 label indicates that the record contains program 
code. 



3.2.3 Constants/label s 

There are four types of object records found in this 
category: 

R3 Identifies a local constant. The name is coded 
in the code bytes. The relative address field 
contains the value of the constant. 

R4 Identifies a local label. The name is coded in 
the code bytes. The relative address field 
contains an offset pointing to the labeled 
location. 

R5 Identifies a global constant. The name is coded 
in the code bytes. 

R6 Identifies a global label. The name is coded in 
the code bytes. 



3.2.4 Global Symbols 

Record type R7 identifies a reference to any global 
symbol. The relative address field is the location 
(within the module) of the reference to the global symbol. 
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CHAPTER 4 
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LINK reads relocatable object modules, resolves references between 
modules r and creates an image file that the operating systan can load 
and execute. 

As relocatable modules are read in, they are placed in a virtual 
address space that resembles the address space the program uses during 
execution. By convention, this address space is divided in half with 
the lower half reserved for program code and constants. The upper 
half is reserved for the stack and other variables. The purpose of 
this convention is to allow the non-changing or pure portions of 
programs to be shared among several users. See figure 4.1. 



4-1 



IMAGE CREATION 



000000 



001000 



100000 



IFEFFF 



Interrupt and Exception Vectors 
(This page physically resides in 
RCM and is shared by all users.) 



Pure Section 

(This area contains constants and 
code which may be shared between 
users.) 



Impure Section 

(This area contains variables and 
data which may not be shared.) 



User Stack 

(The stack starts at IFEFFF and 
grows towards low memory.) 



Fig. 4.1 Memory Map Of The 2-Mbyte Virtual Address Space 

Space is allocated consecutively in these two segments. Allocation in 
each area is controlled by a base pointer that points to the lowest 
unallocated memory location. The pointer into the lower half of the 
address space is called Pure-Base and has an initial value of 1000 
Hex. The pointer into the upper half of the address space is called 
Impure-Base and has an initial value of 100000 Hex. 

As the relocatable modules are read in, they are placed into the 
virtual address space relative to one of these two bases. The base 
pointer chosen depends on the 'RP' or 'RI' type record that must be 
the first record in a module. If the record is type 'RP' the module 
goes into the lower half of the address space. If the record is type 
'RI' the module goes into the upper half of the address space. 

The end of a module is delimited by an 'R8' type of a record. The 
address field of an 'R8' type record contains a count of the number of 
bytes of monory used by the module. When a module has been completely 
read in, the base pointer is incremented by the value of the address 
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field in the R8 record. Thus the pointer once again points to the 
botton of free memory. 

Between the start and end of a module, three classes of records may be 
encountered. The first class causes data to be entered into the 
virtual memory address space. The second class causes symbols to 
become defined. The third class marks a reference to a symbol. 

There is only one instance of the first record class. Ihis is the 
'R2' type of record. This record causes bytes of data to be stored in 
the virtual memory space. 

The second and third record classes affect the linker symbol table 
that is defined by the series of Pascal statanents in figure 4.2. 

TypE Symbol-Table = Record 



Next 
Name 
Value 
Referenced 
End; 



Symbol-Table; 

Packed Array [1..20] of Char; 

Address 

List-of -Undef ined ; 



List-of -Undefined = Record 

Next : List-of -Undef ined; 

Value : Address; 
End; 

Fig. 4.2 PASCAL Definition Of Linker Symbol Table 

Pictorially, the symbol table corresponds to the diagram in figure 
4.3. 
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Symhead 



List-head _ I Next 



T\ 



Name I Value I Referenced 



List-head I Next f I Value 



.Main.O I PFFFFFFF 



r^ 1 


\ I//////////I 






1 ill 00001002 1 







o I start I 00001000 



^:-. 



I//////////I 



First I 00001010 



r*i ^ 


} 1 ////////// I 






1 
i 


\ \ 00001050 1 






> 
1 


\ 1 00001058 1 







Fig. 4.3 Pictorial Representation of LINK Symbol 
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The second record class consists of types 'RQ', 'Rl', 'R5', and 'R6'. 
These result in a symbol table entry being built if one does not yet 
exist and cause the value field of the symbol table entry to iDecome 
defined. 

The third record class consists of only record type 'R7'. An 
occurence of a type 'R7' record causes a symbol table entry to be 
built if one does not yet exist. An entry is then made into a list of 
locations of undefined symbols that is associated with the symbol 
table entry. 

After all of the relocatable modules are read in, LINK precedes to add 
the value field of each symbol table entry to all of the locations 
where it is referenced as specified in the associated list of 
references to undefined symbols. 

After the undefined references have been resolved, the executable 
image file is created. 



4.1 BIT MAP 

The executable image file has a record length of 1024 bytes. The 
first record of this file contains bit maps each of v^ich is 256 
bytes long. These bit maps are: 

1. Disk Memory Correspondence. 

2. Initial Manory Allocation. 

3. Shared Memory Page. 

4. NOT USED. 

These maps are arranged as shown in figure 4.4. 
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$000-OFF 



$100-1FF 



$200-2FF 



$300-3FF 



$400-??? 



disk -memory correspondence map 



record 1 



initial manory allocation map 



shared memory page map 



(not used) 



record 2 



Fig, 4.4 Image File Format 



4,1,1 Disk Memory Correspondence 

The first bit map defines the relationship between the 
2-Mbyte logical address space and the records of the 
executable image file. Each bit of this map corresponds 
to 1024 bytes of memory. If the bit is set, the next 
record from the executable inage file is read into memory 
at the location corresponding to the bit position. 



4.1.2 Initial Memory Allocation 

The second bit map indicates which pages of memory should 
be allocated to the new process. Again, each bit 
corresponds to 1024 bytes in the 2-Mbyte address space. 
The operating system allocates memory to 4096-byte pages. 
Therefore* the setting of any of the bits on the page 
causes the full 4096 bytes to be allocated. 
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4.1.3 Shared Memory Page 

The third bit map is the memory-protection bit map. Ihe 
setting of any of the bits within the range corresponding 
to a 4096HDyte page causes the full 4096 bytes to be write 
protected by the operating syston. This process makes the 
page sharable because the contents cannot be changed. 

There is space for a fourth bit map that is unused at this 
time and is assumed to be zero. 
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LINK uses the content of a library definition file to resolve 
undefined references after all the user-specified files have been 
input - 



5.1 DEFINING A LIBRARY 

To define a library, you create a file containing a list of 
equivalences. An entry in this file is a symbolic name that can 
be referenced followed by the filename of an object module that 
defines the symbolic name. 

You can create this file as a normal text file by using the VEW 
Program (read the Virtual Editing Window (VBW) User Reference 
Manual) . The standard extension for a library definition file is 
.DEF. When referencing a file in an entry, you should enter the 
filename in uppercase and include the file extension. 

A line that begins with an ampersand, @, indicates indirection 
through another library definition file. In this case, LINK 
responds as though the contoits of the other file had been 
inserted at this point. 

Figure 5.1 is an example of a library definition file. 
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. . . Symbolic Name ... I File Name 



1 2 1 3 4 5 
12345678901234567890 I 123456789012345678901234567890 

H 

RRROOO I JDSO/PRTLIB/INIT.MRL 

RRRDOl I _J)SO/PRTLIB/EXIT.MRL 

-PUKTRING I J)SO/PRTLIB.SVC/PUTSTR.MRL 

U)S0/RLIB/ANOTHER-DEF 

Fig. 5.1 Library Definition File 



5.2 PRELINK 



When LINK is ready to use a file, it must translate the name of 
the file to get the File Control Block (FCB) number assigned to 
the file. You can often save time during the linking process by 
performing this translation as a separate step. The PRELINK 
Program does this. Execute PRELINK by typing either of the 
following command-line character strings and then striking 
[RETRN]: 

> prelink linklib.def 

or 

> prelink _dsO/syslib/linklib.def 

PRELINK assumes the file has a .DEF extension if no file 
extension is specified in the FRELINK command-line character 
string. 

PRELINK adds another column to the list of equivalences in the 
.DEF file. Ihis column consists of the FCB numbers of the 
specified files. See figure 5.2 for an example of a library 
definition file after processing by PRELINK. 
. . . Symbolic Name . . , I File Name I FCB Number, 

H . H 



1 2 1 3 4 5 1 6 7 
12345678901234567890 i 123456789012345678901234567890 I 12345678901234567890 

H H 

RRROOO I J}SO/PRTLIB/INIT.MRL I _PS0//#96.1 

RRRDOl I JDSO/PRTLIB/EXIT.MRL I JDS0//#97.3 

JWTSTRING I JDSO/PRTLIB.SVC/PUTSTR.MRL | JDS0//#106.1 

@LDM0/RLIB/AN01HER.DEF 

Fig. 5.2 Library Definition File After Processing By Prelink 

Note: PRELINK creates a new version of the library definition 
file in the same directory as the original file. To 
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conserve disk space, you may want to purge old library 
definition files after running PRELINK. 



5.3 REFERENCING LIBRARIES 
5.3.1 Default Library 



LINK always references the file LINKLIB.DEF, found in 
directory /SYSLIB/ on the syston disk. During 
initialization, LINK reads the contents of this file to 
make the names of library routines available to programs. 



5.3.2 Other Libraries 

To reference another library definition file, use the 
: LIBRARY switch on the command line. For example: 

> link one, two, three :library=test 

The foregoing command tells LINK to link files CNE, TWO, 
and IHREE and reference TEST.DEF as a library file. 
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APPENDIX A 
TROBLESHOOTING 



A,l LINK DIAGNOSTIC MESSAGES 

These are the diagnostic message associated with LINK: 
Display Undefined Symbols 

Checksum Error In Reading Relocatable Module 

Unexpected End of File While Reading Relocatable Module 

Address Of Undefined Reference Accesses Unallocated Disk 
Page 

Open Error (WMCS diagnostic message number) 

Read Error (WMCS diagnostic message number) 

Write Error (WMCS diagnostic message number) 

Close Error (WMCS diagnostic message nuirtier) 

Delete Error (WMCS diagnostic message number) 

A. 2 MISCELLANEOUS ERRORS 

Certain conditions lead to errors that do not give the preceding 
error messages. Some of these conditions are discussed in this 
section. 
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A.2.1 File Empty Or Does Not Exist 

If a specified file is empty or does not exist, the 
message 'Unexpected end of file encountered while reading' 
is displayed followed by the name of the file. Ihe 
solution is to use the T^PE Comirand to display the 
contents of the file. Be certain to specify the filename 
given in the diagnostic message. 



A. 2. 2 Invalid Symbol Address 

LINK does not check the validity of symbol addresses. If 
for seme reason, a symbol has an offset beyond the end of 
its module, this error can happen to be caught during the 
process of adding the actual address to the location of an 
undefined reference. Ihe solution is to examine the 
source modules for unreasonable address offsets. 
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APIENDIX B 
EXAMPLE OF PROGRAM DEVELOPMENT 



The diagram on the next page shows how files produced by the assembler 
and higher-level language compilers may be linked to form an 
executable iirage. A number of relocatable code (.MRL) files can be 
linked in one operation. 
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Assembly 
Source 

PRDGl.ASM 



I 



Pascal 
Source 

PR0G2.PAS 



I 



Assembler 



Pascal 
Compiler 



Print File 
PROGl.PRN 



Relocatable 
Code 

FRDGl.MRL 



Print File 
PR0G2.PRN 








" 


Cross 
Reference 

PROG.MCR 




Executable 
Image 

PROG. EXE 
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APFENDIX C 
RELOCATABLE MDDULE FORMAT 



The relocatable source file contains a series of modules terminated by 
an R9 record. A module is a series of record types R2-R7 preceded 
either by an RO or an Rl type record and terminated by an R8 type 
record. 

REC BYTE CHECK 

TYPE COUNT ADDRESS SUM 

I RO I BC I Al I A2 i A3 I A4 I ## I ## I ## I ## I ... | ## I ## | CS I 

\ / 

\ / 



V 
BYTE COUNT 

The byte count is the number of bytes not including the byte count 
itself. 

REC BYTE CHECK 

TYPE COUNT ADDRESS SUM 

I RO I BC I Al I A2 I A3 I A4 I ## I ## I ## I ## I ... I ## I ## 1 CS I 

\ //l\ 

\ / I 



V I 

^DT(SUM OF BYTES) = CHECKSUM 

The checksum byte is the ones complement of the sum of the bytes. 
This form of checksum was chosen to be compatible with Motorola. 
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RBC BYTE CHECK 

TYPE COUNT ADDRESS PROGRAM NAME SUM 

I RO I BC I Al I A2 I A3 I A4 1 ## I ## I ## I ## 1 ... 1 ## I ## I CS 1 



Delimits the sequence of records pertaining to the main program. 
Otherwise, this type is treated the same as type 6. 

RBC BYTE CHECK 



TYPE COUNT ADDRESS 






WDDULE NAME 








SUM 


1 Rl 1 BC 1 Al 1 A2 ! 


1 A3 


1 A4 


1 ## 1 *# 1 «# 1 


1 ## 1 ., 


.. 1 ## 1 


1 ## 


1 CS 1 



Delimits the sequence of records pertaining to a subroutine. 
Otherwise, this type is treated the same as type 6. 

RBC BYTE CHECK 

TYPE COUNT ADDRESS CODE BLOCK SUM 



1 R2 1 BC 1 Al 1 A2 


1 A3 


1 A4 


1 ## 1 ## 1 


1 ## 1 


1 ## 1 .. 


.. 1 ## 1 


1 ## 


1 CS 1 


REC BYTE 

TYPE COUNT ADDRESS 






LABEL 










CHECK 
SUM 


1 R3 1 BC I Al i A2 


1 A3 


1 A4 


1 ## 1 ## 1 


1 ## 1 


1 ## 1 .. 


.. 1 ## 1 


1 ## 


1 CS 1 



Local constant: 

The label is defined to have the value of the address field. 



RBC BYTE CHECK 

TYPE COUNT ADDRESS LABEL SUM 

I R4 I BC I Al I A2 I A3 I A4 I ## I ## I ## I ## I ... I ## I ## I CS 1 



Local label: 



The label is defined to have the value of the address field plus 
the relocation constant. 
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RELOCATABLE NDDULE FORMAT 



RBC BYTE CHECK 

T!fPE COUNT ADDRESS LABEL SUM 



1 R5 I BC 1 Al I A2 1 A3 1 A4 I ## 1 ## I ## I ## 1 ... I ## I ## I CS I 

Global constant: 

The label is defined to have the value of the address field. 



RBC BYTE CHECK 

TYPE COUNT ADDRESS LABEL SUM 

I R6 1 BC I Al I A2 I A3 I A4 I ## I ## I ## I ## ! ... 1 ## 1 ## I CS 1 



Global label: 

The label is defined to have the value of the address field plus 
the relocation constant. 



REC BYTE CHECK 

TYPE COUNT ADDRESS LABEL SUM 

I R7 I BC I Al I A2 I A3 I A4 I ## I ## I ## I ## I ... | ## | ## | CS 1 



The address field of this record is the location of the reference to 
the undefined label. 



RBC BYTE CHECK 

TYPE COUNT ADDRESS SUM 



R8 I BC I Al I A2 I A3 I A4 I CS 



The foregoing kind of record marks the end of a module. This -record 
contains the amount of space used by the module. The address field 
from the record is added to the current location pointer to form the 
address of the first free location past the end of the module. The 
address of the first free location past the end of the module then 
becomes the new location pointer. 
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RELOCATABLE MODULE FORMAT 



RBC BYTE CHECK 

TYPE COUNT ADDRESS SUM 

|R91BC|A1|A2|A3|A4ICSI 



The foregoing kind of record marks the end of file. The address field 
is undefined. 
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APPENDIX D 
CROSS REFERENCE MAP LISTING 



The following pages display a cross reference map listing from the 
sample program TEST. 
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CROSS REFERENCE MAP LISTING 

WICAT Link Editor - Version 2.2 
Linker map : 



File : TEST.MRL 

.START. Module 1000 

INCREMENTl Module 1006 

TESTO Module 1018 

$PASCAL-GL0BAL$-2 Module 100000 

File : JDIO/PRTLIB/EXIT.MRL 

RRRDOl Label 103E 

File : JDIO/PRTLIB/INIT.MRL 

RRRDOO Label 107E 

File : JDIO/PRTLIB/RTGLOBAL.MRL 

RTGLOBAL Module 10004C 

HEAP Module 10005C 

File : JDIO/PRTLIB/REWRITE.MRL 

RRROll Label 11A4 

File : JDIO/PRTLIB/RESET.MRL 

RRRDIO Label 1268 

File : JDIO/PRTLIB/FBINIT.MRL 

RRR009 Label 1352 

File : JDIO/PRTLIB/SHOWIO.MRL 

SHOWIO Label 13 9E 

File : JDI0/PRTLIB/ERROR.MRL 

ERROR Label 13FE 

File : J)1 0/PRTL IB/HANG. MRL 

HANG Label 1450 

File : _PI0/PRTLIBA?HEX.MRL 

RRRD39 Label 1498 

File : JDIO/PRTLIB/PUT.MRL 

RRRD22 Label 1530 

File : JDIO/PRTL IB/GET. MRL 

RRR021 Label 16AC 

File : _PI0/PRTLIB/MBVALID.MRL 

RRRD20 Label 1728 



Base - Pure= 



Used 
Base 

Used 
Base 

Used 
Base 



Used 
Base 

Used 
Base 

Used 
Base 

Used 
Base 

Used 
Base 

Used 
Base 

Used 
Base 

Used 
Base 

Used 
Base 

Used 
Base 



Pure= 
Pure= 

Pure= 
Pure= 

Pure= 
Pure= 



Pure= 
Pure= 

Pure= 
Pure= 

Pure= 
Pure= 

Pure= 
Pure= 

Pure= 
Pure= 

Pure= 
Pure= 

Pure= 
Pure= 

Pure= 
Pure= 

Pure= 
Pure= 

Pure= 
Pure= 



Used - Pure= 



1000 Iinpure=100000 

6 

12 

26 

4C 

3E Impure= 4C 

103E Impure=10004C 

40 

40 Impure= 

107E Impure=10004C 

126 

126 Impure= 

nA4 Impure=10004C 

20 

Iinpure= 20 

11A4 Impure=10006C 
C4 

C4 Impure* 

1268 Impure=10006C 
EA C 

EA Impure* 

1352 Impure=10006C 
4C 

4C Impure* 

139E Impure=10006C 
60 

60 Impure* 

13FE Impure*10006C 
52 

52 Impure* 

1450 Impure*10006C 
48 

48 Impure* 

1498 Impure*10006C 
98 

98 Impure* 

1530 Impure*10006C 
17C 

17C Impure* 

16AC Impure*10006C 
7C 

7C Impure* 

1728 Impure*10006C 
ICO 

ICO Impure* 
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CROSS REFERENCE MAP LISTING 



File : JDIO/PRTLIB/CLOSE.MRL 
** Unable to open by FCB! 

RRR019 Label 

RRH)19A Label 



Base - Pure= 18E8 Iiiipure=10006C 



18E8 








18E8 




F4 





Used • 


- Pure= 


F4 Iinpure= 






_3EAP 



Symbol 



10006C 



Image filename = TEST. EXE 

Total image size (all sizes given in hexadecimal) = 
9DC bytes pure code. 
6C bytes impure code. 
bytes reserved for dynamic space. 
1000 bytes reserved for stack. 
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CROSS REFERENCE MAP LISTING 

WICAT Link Editor - Version 2.2 
Symbol Cross Reference 



$PASCAL-aOBAL$-2 


100000 


lOOE 


lOlA 


1020 


102C 






.START. 


1000 














ERROR 


13FE 


1230 
18B0 


131E 
19A4 


13B0 


13D2 


145E 


156A 16E6 


HANG 


1450 


123E 


132C 


1578 


16F4 


18BE 


19B2 


HEAP 


10005C 


1150 












INCREMENl'l 


1006 


1034 












RRRDOO 


107E 


1026 












RRRDOl 


103E 


103A 


1454 










RRRD09 


1352 


1102 


1130 


198A 








RRROIO 


1268 


1140 












RRRDll 


11A4 


1112 












RRRD19 


18E8 


IIBA 


127E 










RRR019A 


18E8 














RRRD20 


1728 


16C6 












RRRD21 


16AC 


12E4 












RRR022 


1530 


1514 












RRRD39 


1498 


13C8 












WiXiLOBAL 


10004C 


1044 


105A 


1118 


1146 


13B6 


1408 


SHOWIO 


139E 


1238 


1326 


1572 


16EE 


18B8 


19AC 


TESTO 


1018 


1002 












_HEAP 


10006C 


115A 
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APFENDIX E 
BIT MAPS AND RECORDS 



This appendix contains bit maps and records for the sample program 
TEST. These bit maps and records are a hexadecimal dump of the inage 
file for the TEST program. 



E-1 
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FILE: JDIO/TOM.CDS/TEST.EXE.l 



1 00000000 


OE 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 00000010 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 00000020 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 00000030 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 00000040 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 00000050 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




I 00000060 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 ' 


First 


1 00000070 


00 


00 


00 


00 


00 


00 00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


Bit 


1 00000080 


80 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


Map 


1 00000090 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


L 


1 OOOOOOAO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 OOOOOOBO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




I OOOOOOCO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 OOOOOODO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 OOOOOOEO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 OOOOOOFO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 00000100 


OE 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


- 


! 00000110 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 00000120 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 00000130 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 00000140 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 00000150 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




! 00000160 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 00000170 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


Second 


i 00000180 


80 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


Bit 


1 00000190 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


Map 


1 OOOOOIAO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 OOOOOIBO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 OOOOOICO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 OOOOOIDO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 OOOOOIEO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 OOOOOIFO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


OF 




Record! 
































,_„ 


. 


1 00000200 


OE 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 00000210 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




I 00000220 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 00000230 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 00000240 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 00000250 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 00000260 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


Third 


1 00000270 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


Bit 


1 00000280 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


Map 


1 00000290 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 000002A0 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 000002B0 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 000002C0 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




1 000002DO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 
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BIT MAPS AND RECORDS 



1 000002E0 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 1 


1 000002F0 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 1 


1 00000300 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 1 


1 00000310 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 1 


1 00000320 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 1 


1 00000330 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 i 


1 00000340 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 1 


1 00000350 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 1 


1 00000360 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 1 Fourth 


1 00000370 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 1 Bit 


I 00000380 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 1 Map 


1 00000390 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 1 


1 000003A0 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 1 


1 000003B0 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 1 


1 000003C0 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 1 


I 000003D0 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 1 


1 000003E0 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 1 


1 000003F0 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 1 


1 00000400 


4E F9 


00 


00 


10 


18 


4E 


56 


FF FC 


2D 


OD 


52 


79 


00 


10 NyNV|-i^ 


! 00000410 


00 


4A 2A 5E 


4E 


5E 


4E 


75 


2F 


3C 


00 


10 


00 


06 


2F 


3C J*"N"Nu/</< 


1 00000420 


00 


10 


00 


28 


4E B9 


00 


00 


10 


7E 


42 


79 


00 


10 


00 


4A (N9~ByJ 


1 00000430 


2A 


4E 


4E B9 


00 


00 


10 


06 


4E B9 


00 


00 


10 


3E 


4E 


56 *NN9N9>NV 


I 00000440 


FF 


F8 


20 


7C 


00 


10 


00 


50 


20 


50 


2F 


28 


00 


08 


42 A7 X IP P/(B' 


1 00000450 


48 6E FF FC 


4E 


40 


00 


03 


20 


7C 


00 


10 


00 


4C 


20 


50 HniN@ IL P 


1 00000460 


2F 


28 


00 


08 


42 A7 


48 


6E FF FC 


4E 


40 


00 


03 


42 A7 /(B'Hn|N@B' 


I 00000470 


42 A7 


42 


A7 


48 6E FF FC 


4E 


40 


00 10 60 FE 28 4F B'B'Hn|N@'~(0 


1 00000480 


42 


81 


20 


OF 


OC 


80 


00 


IF 


FF 


EC 


6E 


44 


20 


2F 


00 OC B InD / 


1 00000490 


OC 


80 


00 


00 


OF 


FF 


6E 


38 


20 


6C 


00 


10 


Dl 


CO 


Bl FC n8 1Q@1| 


1 000004A0 


00 


IF 


FF 


FF 


6E 
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WICAT Systems, Inc. 

Product-documentation Comment Form 

We are constantly improving our documentation, and we welcome scecific comments on rhis manual. 

Document Title: = 

Part Numben _^ -^_^___-_ 

Your Position: D Novice user n System manager 

D Experienced user D Systems analyst 

a Applications programmer D Hardware technician 

Questions and Comments Page Na 

Briefly describe examples, illustrations, or information that you think should be added 
to this manual. 



What would you delete from the manual and why? 



What areas need greater emphasis? 



List any terms or symbols used incorrectly. 
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